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About five minutes ago, about two hours before this issue goes 
to the printer, our UPS driver delivered one review copy of 
Programming the 65816, by David Eyes and Ron Lichty. IT'S 
HERE! And it looks excellent. I have time and space for only 
a few words here; we expect to have a complete review of this 
book and Fischer's next month. 


Eyes and Lichty have given use over 600 pages of introduction, 
architecture, tutorial, application, and reference information, 
including a 60-page chapter listing and describing in detail 

the source code for a rudimentary 65816 Tracer/Debugger. This 
book has complete information on ALL the 65x family processors, 
from the original 6502 up through these latest 16-bit versions. 


We expect delivery of our inventory within the next week or two 
and we'll start shipping your copies as soon as we get them. 
Remember, our price is $21 + shipping. 


Minor Correction to Bob's New QUIT Code......-...-2ee-brv Edge 


Bob's new QUIT code for ProDOS is nice! There is one minor 
error at line 3390, which causes an extra character to be 
printed. Change "BNE .1" to "BPL .1" and it will work better. 
The extra character was only noticeable when the filename was 
15 characters long, or had been RENAMEd to a shorter name than 
it previously had, because filenames are normally filled out 
with null characters. 


You can also save one byte by changing line 4290 from "JMP MSG" 
to "BNE MSG". The BNE will always branch in this case, and is 
one byte shorter than the JMP. 


Fast Integer Square RootS......+.eeeeeeeee-BOb Sander-Cederlof 


In the sree 1986 issue of Dr. Dobb's Journal, Robert Pirko gave 
an algorithm and a program to calculate the square root of a 


16-bit integer. (Letter, pages 10-12; program, pages 60-66.) 
His program wasS written in 8088 assembly language for the IBM 
PC. I decided to try writing the same algorithm in 6502 code. 


As with most square root algorithms, Pirko's depends on the 
so-called Newton-Raphson iteration. In simple algebra, this 
means that a “pretty good" approximation to the square root of 
N can be made “much better" by the formula: 


1 N 


much better = ---( pretty good + ----------- ) 
2 pretty good 


How many times you have to use the formula depends on how close 
your first guess is, and how much precision you need. By the 
Gefinition of “integer square root", we are looking for the 
largest 8-bit integer whose square is less than or equal to the 
16-bit argument N. Therefore, we need only 8-bit precision. 


The formula refines the answer rapidly, roughly doubling the 
number of precise bits each time. So if we start with a close 
enough initial guess, once through the formula might be plenty. 


What Pirko did was experiment to find a set of rules to get a 
"good enough" initial guess. Once through Newton-Raphson re- 
fined the guess to 8-bit precision, except that the truncation 
errors Of integer arithmetic resulted in some roots being too 
large by 1. By Squaring the calculated root and comparing the 
Original number, Pirko could decrement those which needed it. 


Pirko'sS program was pretty fast. He tested speed by taking the 
Square roots of all integers from 0 to 65535, with the average 
time being 91 microseconds on his IBM PC (he didn't say which 
version, or what clock frequency). Any time I see a timed 
program like this, my benchmarking blood begins to bubble. 
However, the Apple is not as fast this time, because of the 
need for a division and a multiplication. The 8088 has opcodes 
for multiply and divide, while the 6502 does not. 


Here are Pirko's rules for obtaining an initial guess: 


Argument 
Range Root or Initial Guess 


0000-0001 root = N 


0002-00FF guess = N/16 + 3 
0100-OFFF guess = Nhigh*4 + 13 
1000-7FFF guess = Nhigh + 50 
8000-D7FF guess = Nhigh + 40 
D800-FEFF guess = 255 


FFOO-FFFF root = 255 


After playing with various versions of the program, I settled 
on a Slightly different set of rules. The average time was 
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S-C Macro Assembler Version 2.0.-....DOS $100, ProDOS $100, both for $120 
Version 2.0 DOS Upgrade Kit for 1.0/1.1/1.2 ownerS....... cece veveveeee S20 
ProDOS Upgrade Kit for VerSion 2.0 DOS OWnerS...c ccc ccenervcccsece ~~ $30 
Source Code of S-C Macro 2.0 (DOS only)......-.2.-eeeee2--additional $100 
Full Screen Editor for S-C Macro (with complete source code)..........$49 
S-C Cross Reference Utility......without source code $20, with source $50 
RAK-Ware DISASM...ccccccceees « ewithout source code $30, with source $50 
S-C Word Processor (with complete source COde) ....crcrcscvevscccvcveve QIU 
DP18 Source and ODJECt.. ccc -cecccccrovecasccccecsseerceseessessseves es pu 
Double Precision Floating Point for Applesoft (with source code)......$50 
ES-CAPE (Extended S-C Applesoft Program Editor)......ce.0. 
Including Version 2.0 With Source Code..........$50 
ES-CAPE Version 2.0 and Source Code Update (for Registered Owners)....$30 
Bag of Tricks 2 (Quality Software) ....-cccccccccccsveveceeee (949,95) $45 
Copy II Plus (Central Point Software) ......ccccccccccccccese (939-99) $35 
Applesoft Toolbox Series (Roger Wagner Publishing).....each ($39.95) $36 
all four ($159.80) $140 
MacASM -- Macro Assembler for MacIntosh (Mainstay).........($150.00) $100 
S-C Documentor (complete commented source code of Applesoft ROMs).....$50 
Cross Assemblers for owners of S-C Macro Assembler.....$32.50 to $50 each 
(Available: 6800/1/2, 6301, 6805, 6809, 68000, Z-80, Z-8, 8048, 
8051, 8085, 1802/4/5, PDP-1l, G1I1650/70, others) 


+t + 2 


AAL Quarterly DiSkS....-.-cccccccceccese-eee-eachn $15, or any four for $45 
Each disk contains the source code from three issues of AAL, 
Saving you lots of typing and testing. 
The quarters are Jan-Mar, Apr-Jun, Jul-Sep, and Oct-Dec. 
(All source code is formatted for S-C Macro Assembler. Other assemblers 
require some effort to convert file type and edit directives.) 


Diskettes (with hub ringS).....ccece-s-cecvecccceseee package of 20 for $20 * 
Vinyl disk pages, 6"x8.5", hold two disks each.....c.cccccccceeelO for $6 * 
Diskette Mailing Protectors (hold 1 or 2 disks).......¢++.+-40 Cents each 
(Cardboard folders designed to fit 6"X9" Envelopes.) or $25 per 100 * 
Envelopes for Diskette MailerS......-.-cccccccscsescccscccecce 6 Cents each 


65802 Microprocessor (Western DeSign Center) ....ceseccscrceeeee ($95) $50 
quikLoader EPROM SyStem (SCRG) ..ccccccvcccccscccccsveccecvesvees(Sl1/9) $170 
PROMGRAMER (SCRG) .cccccscccccrsrcrerccerccccvccecccccccvece (9149.50) $140 
Switch-a-Slot (SCRG) va éo.seewds Sw. 6 oid ike wie ee ie 6 ewe Oe we ea eras (9179590): S170 
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"65816/65802 Assembly Language Programming", Fischer......--($19.95) $18 
“Programming the 65816", EyeS....-.-ccccscccccsvvccccsseeees ($22.99) $21 
“Apple //e Reference Manual", Apple Computer.....csecceesoee ($24.95) $23 
"Apple //c Reference Manual", Apple Computer.....cceccceeeee ($24.95) $23 
“ProDOS Technical Reference Manual", Apple Computer.........($29.95) $27 
“Now That You Know Apple Assembly Language...", Gilder......($19.95) $18 
“Apple ProDOS: Advanced Features for Programmers", Little..($17.95) $17 
"Inside ‘the Apple .//¢"; Littles soccww ssewses oaie a Gaw Seeees ea (S19.95). “S18 
“Inside the Apple //e",» LiIttlés<csscstecevcese+sacecvceseesss ($19.95) $18 
“Apple II+/IIe Troubleshooting & Repair Guide“, Brenner.....($19.95) $18 
“Apple ]{ Circuit Description", Gayler......-ccccccccceeveee (922.99) $21 
"Understanding the Apple II", Sather... .ccccvcesvsccseeseee (922.99) $21 
“Understanding the Apple //e", Sather..ccccccccccceesecessee (924.95) $23 
"Enhancing Your Apple II, vol. 1", Lancaster......cccceeeeeee ($15.95) $15 
“Enhancing Your Apple II, vol. 2", LancaSter...cccccseeeeeee (917.99) $17 
“Assembly Cookbook for the Apple II/IIe", Lancaster.........($21.95) $20 
"Beneath Apple DOS", Worth & LECHNEL.. cc ccecevccnecves-ceeee (919.95) $18 
“Beneath Apple ProDOS", Worth & Lechner....-ceccceccccseesee (919.95) $18 
“Real Time Programming -- Neglected Topics", Foster.......e+++- ($9.95) $9 
"Microcomputer GraphicS", MYELS.cccee-ceccccccccccscvcseseee ($914.95) $14 
“Assem. Language for Applesoft Programmers", Finley & Myers.($18.95) $18 
“Assembly Lines -- the Book", WagGn€Lr...ccccccccccscvcccececs (919.95) $18 
“AppleVisions", Bishop & GrOSSDErger..cececscccessccevcceese ($39.95) $36 


e+e eee eee eee euen eee He HHH HH HD OD 


* On these items add $2.00 for the first item and 
$.75 for each additional item for US shipping. 
Foreign customers inquire for postage needed. 
Texas residents please add 6 1/8 % sales tax to all orders. 


*** S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *** 
kkk kat 


(214) 324-2050 
*** Master Card, VISA, Discover and American Express *** 
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reduced a little by changing the third and fourth ranges: 


0100-O8FF guess = Nhigh*4 + 13 
0900-7FFF guess = Nhigh + 50 


It is not difficult to separate out the seven cases and 
calculate the initial guess. Lines 1130-1460 in the program 
below do all that work. Lines 1480-1530 perform the Newton- 
Raphson formula once. Lines 1540-1630 decrement the root if 
its Square exceeds the original argument. 


Since the 6502 does not have any multiply or divide opcodes, I 
coded these two operations as subroutines. My division subrou- 
tine divides the 16-bit value in ARGHI,ARGLO by the 8-bit value 
in GUESS, leaving the answer in QUOT and REM. My multipli- 
cation subroutine multiplies the 8-bit value in the A-register 
by the 8-bit value in ROOT to get a 16-bit product in PROD. 


The program named MT (lines 3390-3850) does a complete test of 
the Square root subroutine. MT calls on SQR for each possible 
argument from 0 through 65535 (SFFFF), then tests the value of 
ROOT by squaring it. If the Square is larger than the argu- 
ment, there waS an error. If not, I increment the root and 
Square it again. If this square is not larger than the 
argument, there waS an error. If either type of error occurs, 
I display the argument and the root. 


Once I was sure SQR waS producing correct answers, I wrote a 
timing routine (lines 2110-2430) which runs through all values 
0-65535 ten times. By changing line 1190 to "1190 SQR RTS" I 
timed the overhead of the 655360 calls (13.2 seconds). When I 
changed line 1190 back, the additional time was 273.3 seconds. 
This is an average of 417 microseconds per root, over 4 times 
Slower than the IBM program. 


I wanted to see what the 6502 could do IF it had multiply and 
divide opcodes in hardware. Assuming each would take no more 
than 12 cycles, I changed lines 1740 and 1940 to RTS's. The 
resulting time averaged 74.3 microseconds per root. If only we 
had DIV and MUL, we could easily beat the PC in this benchmark. 


We can come a little closer by playing a dirty trick. Since we 
know that the test program runs through all the arguments in 
sequence, we know that the Squaring operation will usually be 
doing the same number over and over. For example, the root SFE 
comes out of the Newton-Raphson formula over 500 times! By 
giving the MUL routine a memory, we can save the root squared 
last time. Lines 1950-1970 are all we need to add. Simply 
remove the asterisks and re-assemble. With this trick, the 
average root took only 248 microseconds. We can also save 
about 24 microseconds per root by putting the MUL and DIV sub- 
routines "in-line", eliminating the JSR and RTS (with the dirty 
trick, in-line code only saves an additional 12 microseconds). 


Some time ago, Technical Education Research Centers (TERC) pub- 
lished information on the Hitachi 6203 multiply/divide chip and 
how to interface it to the Apple. We mentioned this in AAL a 
few years back. That chip allows you to code the division in 
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my program to run in 33 cycles, and the squaring in 30 cycles. 
The result would still be a little slower than the PC. By the 
way, all I know about the 6203 I got from TERC's newsletter. I 
have never been able to get any information whatsoever out of 
Hitachi about it, and I have never actually seen the chip. I 
sure would like to! (If you are interested in TERC, try 
calling Bob Tinker or his associates at (617) 547-0430, or 
write to TERC, 1696 Massachusetts Avenue, Cambridge, MA 02138.) 


I am not finished yet. I Spent another half day investigating 
a different technique for getting the integer square root. 

This is a binary adaptation of the mysterious method we learned 
and forgot in high school. Can you remember how we did it? I 
know at least a few of you can, because you are in high school 
right now. And others, because you are high school teachers. 
Anyway, it is too difficult to explain in these few lines. The 
same algorithm in binary is pretty straightforward. I present 
it in lines 2490-3020, without much comment. It works, but it 
takes an average of about 880 microseconds per root. The test 
routine in lines 3040-3350 takes the square root of evey value 
from 0-65535 using both SQR and NEWSQR, and compares the 
results. If they are different, it prints the data. 


It is now nearly a month since I wrote all the preceding para- 
graphs in this article. Today the latest Dr. Dobbs Journal 
arrived, and a pair of letters referred to some old articles 
about integer Square roots. I looked them up, and learned an 
eaSier way to apply the “high school“ method. The resulting 
6502 program won't fit in this issue, but is included on the 
Monthly and Quarterly Disks. This version takes an average ot 
737 cycles per root. It looks like a 65802 native mode version 
would be significantly faster. 


Naturally, I expect at least one of you to come up with a 
Significantly better and faster program than any of mine. 


1000 *SAVE S.INTEGER.SQRT 


1020 Sanenee teas ok eoseescseanao secs 
00- 1030 ARGLO .EQ 0 
Oi- 1040 ARGHI .EQ 1 
02- 1050 GUESS .EQ 2 
03- 1060 QUOT .EQ ; 
05- 1080 ROOT EQ ? 
06-—- 1090 PROD -EQ 6,7 
08- 1100 TRIPS .EQ 8 
09— 1110 PREVIOUS.ROOT .EQ 9 
OA- 1120 BITHI . 10 
OB- aie BITLO . 11 
0C- 1140 SUBHI EQ 12 
OD- 1150 SUBLO .EQ 13 
OE- 1160 WORKHI .EQ 1 
OF- ae WORKLO .EQ 15 
1180 Bepmn nn men nnn nnn nn nnn nnn nn nee 
1190 SQR 
O800- A5 01 1200 LDA ARGHI 
0802- 30 OE 1210 BMI .1 32768 OR MORE 
O804- DO 18 1220 BNE .2 256... 32767 
0806- A5 00 vat LDA ARGLO 
O808- 4A 1240 LSR 
O80B- 4A 1260 LSR 
O80C- 4A oho LSR 
O80D- 4A 1280 LSR 
O8SOE- 69 93 1290 ADC of (2...5 IS OKAY HERE 
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Ram Factor 


All the Performance, Speed, and Software 
Compatibility of RamWorks” in a Slot 1 through 7 Card. 


Features: 

e Up to 16 meg total memory, 256K to 1 
meg on main board Up to 16 meg with 
additional memory on piggyback card 

e Fully Apple I Memory Expansion com- 
patible 


e Compatible with Apple Ile, I+ and 
Franklin 


e Battery back-up option allows you to tum 
on your Apple and run your favorite 
programs in less than 1 second! 

e Automatically recognized by ProDos, DOS 
3.3, Pascal and CP/M 

| e Built-in RamDrive™ software (a tue RAM 


A ie right! Now Applied Engineering offers you a choice. While RamWorks is the dear 
winner for the auxiliary slot in a Ile, RamFactor is the standard for slots 1 through 7. Now 
anyone with an Apple II+, Franklin, or Apple Ile preferring to use slots 1 through 7 can now 
enjoy the speed and performance that until now was only available with RamWorks. 

With RamFactor, you'll be able to instantly add another 256K, 512K, or a full 1 meg on the 
main board and up to 16 meg with additional piggyback card. And since virtually all software 
is automatically compatible with RamFactor, you'll immediately be able to load programs into 
RamFactor for instantaneous access to information. You'l also be able to store more data for 
larger word processing documents, bigger data bases, and expanded spreadsheets 


e Automatic expansion with AppleWorks 1.3 


ae or later 
| ¢ Allows Apple II+ and Te to run your 
AppleWorks without buying additional 
software 
Very Compatible column card. RamFactor, no other standard . Accelerates AppleWorks 
All the leading software is already com slot card comes close to enhancing Apple e Displays time and date on the AppleWorks 
patible with RamFactor. Programs like Apple | Works so much Be Sait baie tices 
Works, Pinpoint, BP, Managing Your Money, | True 65C816 16 Bit Power ae 
Write pa => est pace gue RamFactor has a built-in 65C816 CPU port | , Much, much more 
for direct connection to our Ile 65C816 card 
Speller, Applewriter Ile, Business Works, for li idressing “up wo 16 men for the 
Rep onwode el 2 Vand mer And most powerful 16 bit applications. (I+ RamFector with 256K 


RamFactor is fully ProDos, DOS 3.3, Pascal 1.3 
and CP/M compatible. In fact, no other 
memory card (RamWorks excepted) is more 
compatible with commercial software. 
AppleWorks Power 

There are other slot 1-7 cards that give 
AppleWorks a larger desktop, but that’s the 
end of their story. But RamFactor is the only 

~ slot 1-7 card that increases AppleWorks 

intemal memory limits, increasing the maxi- 
mum number of records in the database and 
lines permitted in the word processor, and 
RamFactor is the only standard slot card that 
will automatically load AppleWorks into RAM 
dramatically increasing speed and eliminating 
the time required to access the program disk, 
it will even display the time and date on the 
AppleWorks screen with any ProDos dock 
RamFactor will automatically segment large 
files so they can be saved on 5%”, 32”, and 
hard disks All this performance is available to 
anyone with an Apple Ile or II+ with an 80 


RamFactor with 512K 


65C816 card under development 
) RamFactor with 1 MEG 


Powerful Program Switcher 

With RamFactor, you can organize 
memory into multiple work areas and switch 
between them. Each work area can contain 
different programs and even different operat- 
ing systems. Now you can switch from one 
program to another or even switch from 
AppleWorks to DOS 3.3 to CP/M to Pascal to 
ProDos in under a second. And with our 


RamFactor with 2-16 MEG 
Battery Back-up Option 
65C816 16 Bit Card 


Order RamFactor today . . . with 15 day 
money back guarantee and our “no hassle” 
five year warranty. Cal9 am. to 11 pm, 7 
days, or send check or money order to 


Battery back-up option, you can have Applied Engineering, MasterCard, Visa and 
permanent storage for up to 20 years. COD. welcome. Texas residents add 5%% 
Quality and Support of the sales tax. Add $10.00 if outside USA 
Industry Leader 

RamFactor is from Applied Engineering, 


the largest, most well supported manufacturer 
of Apple peripherals and the inventor of large 
RAM cards for the Apple. With our 5 year no 
hassle warranty and outstanding technical 
Support, you're assured of the most rouble 
free product you can buy. 


/E. Applied Engineering” 
The Apple enbancement experts 
(214) 241-6060 


P.O. Box 798, Carrotiton, TX 75006 
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1310 #-.~- 32768.. - 65535 SS eS eee ea eae 

0812- C9 FF 1330 : P #255 

0814- FO 30 1330 oT eee hi cee 

0816- 69 28 1340 ADC #40 35...44 OKAY) 

0818- 90 10 1350 4 

O81A- AQ FF 1360 LDA #255 

081C- DO OC 1 i 4 - ALWAYS 
13 0 #---256... 32 67 Se SL LSS 

O81E- C9 0 1330 ° CMP #$0 

O820- BO 0 1400 BCS . 30900-: Ha 

OS22= OA 1410 ASL 0100.. 

0823- OA 1420 ASL 

O824- 69 OD rae ADC #13 

0826- DO 02 1440 BNE .4 »- ALWAYS 
1450 #.~-~$0900. ee $7FFF SS ES en ee 

0828- 69 31 1460 . ADC #49 ADDS 50 (50...61 OKAY) 
ia #.~--DQO NEWTON ONCE--------------- 

O82A- 8 "3 1480 .4 STA GUESS 

O82C=- 2 C 08 1490 JSR DIV 

O82F- 18 1500 CLC 

0830- A5 03 1510 LDA QUOT 

0832- 65 02 1520 ADC GUESS 

0834- 6A rat ROR 
15 $.--SQUARE THE RESULT------------ 

0835- 85 0 1550 STA ROOT 

0837- 20 67 08 1560 JSR MUL 
Ley bs #.--DECREMENT ROOT IF TOO BIG---- 

083A- A5 0 1580 LDA ARGLO 

083C- C5 06 1590 CMP PROD 

08 BE - A5 01 1600 LDA ARGHI 

O840=- E5 07 1610 SBC PROD+1 

O842- A5 05 1620 LDA ROO 

O844- EO 1330 ‘ SBC #0 DECREMENT IF TOO BIG 

O846- 85 05 1850 oT STA ROOT 

0848- 60 1660 RTS 
ore Bonen neem en nn mmm enn enone eee 

of a 2A 1 0 .8 ROL RESTORE O OR 1 

OS4A- 90 FA O80 . BCC .7 ~- ALWAYS 
1710 ® DIVIDE (ARGLO,ARGHI) BY (GUESS) 
1430 ; LEAVE ANSWER IN QUOT, REM 
1780 DIV 

O84C- AO 08 1750 LDY #8 

O84E- A5 00 1760 LDA ARGLO 

0850- 85 03 it STA QUOT 

0852=- A5 01 1780 LDA ARGHI 

0854- 06 03 th a6 ot ASL QUOT 

0856- 2A 1800 ROL 

0857- BO 04 1810 BCS .15 

083 2- C5 02 1820 CMP GUESS 

O85B- 90 04 1830 BCC .2 

O8aD- E5 02 18 QO .15 SBC GUESS 

O85F- E6 03 1850 INC QUOT 

0861- 88 1860 .2 DEY 

0862- DO FO 1870 BNE .1 

O864- 85 04 ieee STA REM 

0 - 60 1890 RTS 
1900 Sewn nn enn w nn nn nen een eee nene 
1910 # MULTIPLY (ROOT) BY (A-REGISTER) 
1920 ® PUT RESULT IN PROD, PROD+1 
vabe fee mn wm nn nn nn nn none nnnen= 
1940 MUL 
1950 #88 CMP PREVIOUS. ROOT "DIRTY TRICK" 
1960 ##8 BEQ .7 ditto 
La diated STA PREVIOUS.ROOT ditto 

0867- 85 02 1980 STA GUESS 

0869= AQ 00 1990 LDA #0 

08 6B- Ao 08 2000 LDY #8 

O86D- 46 02 2010 .5 LSR GUESS 

O86F- 90 03 2020 BCC .6 

0871- 18 2030 CLC 

OTF 65 05 2040 ADC ROOT 

O874—- 6A 2050 .6 ROR 

0875- 66 06 2060 ROR PROD 

O877- 88 2070 DEY 

0878— DO F3 2080 BNE .5 
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85 07 2090 STA 
60 2100 .7 RTS 
2120 T 
AQ OA 2130 LDA 
85 08 2140 STA 
AQ 00 2150 LDA 
BP 01 2160 STA 

00 2170 STA 
85 09 2180 STA 
20 00 08 2200 .1 JSR 
2210 ~DO O 
222 LDA 
2230 JSR 
2240 LDA 
2250 JSR 
2260 LDA 
2270 JSR 
2280 LDA 
2290 JSR 
2300 LDA 
2310 JSR 
2320 JSR 
2330 -FIN 
E6 00 2350 INC 
DO F 2360 BNE 
EE F7 O07 2370 INC 
E6 01 2380 INC 
DO Fe 2390 BNE 
EE F5 07 2400 INC 
C6 O 2410 DEC 
DO EB 2420 BNE 
60 24 : RTS 
20 DA FD 2450 PRB JSR 
AQ AO 2460 LDA 
uC ED FD Siike JMP 
2480 
2490 NEWSQR 
AO 08 2500 LDY 
A5 01 2510 LDA 
85 OF 2520 STA 
A5 00 2530 LDA 
85 OF 25 STA 
AQ 00 2550 LDA 
85 OD 2560 STA 
85 OA 2570 STA 
AQ 40 2580 LDA 
85 OC 25 STA 
85 OA 2600 STA 
38 2620 «1 SEC 
A5 OF 2630 LDA 
E5 OD 2640 SBC 
AA 2650 
A5 OE 2660 LDA 
E5 OC 2670 SBC 
0 O04 6 0 BCC 
5 OE 2690 STA 
86 OF 2790 STX 
08 2710 .2 PHP 
26 05 2720 ROL 
A5 OC 2730 LDA 
45 OA 2740 EOR 
HA 2750 LSR 
85 OC £1 60 STA 
A5 OD 0 LDA 
45 OB 2780 EOR 
6A 2790 ROR 
85 OD 2000 STA 
2 2810 PLP 
90 OC 2820 BCC 
A5 OC 28 30 LDA 
de OA 38 ) EOR 
0c 2850 STA 
--e- Apple Assembly Line.. 


PROD+1 SAVE HI-BYTE OF SQUARE 


# 
ARGHI 


WORKHI Save 


# 
SUBLO BITO 


Loop 8 times for an 8-bit root 


working copy of argument 


Trial subtraction 


WORKLO 
SUBLO 


Save lo-byte of difference 


WORKHI 
SUBHI 


ee ~»e WORKi < SUBi 
WORKHI Save new value for WORK 


WORKLO 


Save carry status (next ROOT bit) 
ROOT ROOT = ROOT#2 + CARR 
SUBHI SUB = (SUB .EOR. BIT)/2 


BITHI 
SUBHI 
SUBLO 
BITLO 


SUBLO 


a3 --e WORK was less than SUB 
SUBHI SUB = SUB .EOR. BIT 


BITHI 
SUBHI 
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Computing at warp speed! 

Its an experience vou shouldnt miss And with TransWarp, vou 
wont have to) Because Trans Warp wall run vour software up to 36 
times faster leaving other accelerators inthe sturdis’ 

No more vawning while vour Apple slowly rearranges text or 
calculates spreadsheets With 250K of ultra fist RAM. Trans arp 
speeds up a// Apple software inclucing AppleWorks. Supercale 
ane Ristane and all cducatonal software, graphics and games. And 
its compatible with all standard peripheral cards Csuch ats Ram: 
Works Hand Apple memory cards) Profile and Sider bard: disks, 
41" CiibDisks. 8O-colummn cards, modems. clock curds, mouses tnd 
more’ You name it, TransWarp accelerates th) Theres event 16 bit 
upgrade chip wwaikible should 16 bit software become available for 
the Apple 


‘T recommend Applied 
Engineering products 
u'holebeartedl: ” 


Steve Wozniak, the creator 
of Apple Computer 


An important difference. 

TransWarps not the only speedup card on the market But its 
the only one chat accelerates vour Apples main memory, ROM 
and auxiliary memory And with more and more prowrams 
residing in auniliary memory, buving anvone elses accelerator 
mutkes less and less sense TransWarp even works with most 
DMA. devices including the Swvtt' curd, 

Theres one more difference. Since TransWarp doesnt use men: 
ory caching. itaccelerates a@/f software and not just most Of it 


A cinch to use. 


Simply plug TransWarp into any slot in vour Apple UL, H+ or He 
Including slot 3 in the He Instantly vou be compunng at 
speeds vourconly dreamed about before And should vou ever wish 


Get TransWarp’ The Jastest accelerator you can buy 


for your Apple” 


lle, If, or I+. 


to run abnormal speed. simply press the ESC key while turning 
vour Apple on 

Since Trans Warp is completely: transparent, Vou wort ACE pre 
boot disks or special software: [ts mak to go Teht out of 
the package 
Speed = Productivity 

Imaging the productiviny gains Vout achiese when your pro- 
grams are running over three times faster TransWarp is so power 
ful. vour Apple will make IBM PCs and even ATS look like 
slowpokes Whether voure planning taxes, ploting charts or 
plaving games! Take a look ata few of the reatures that set 
TransWarp apart 
£3.60 MHZ 05002 
© 250K of ultrafast on-board 


e Totally Cransparent operanon 
with atl] software 


RAM * Plays nto an slot wicluding 
© Accelerates miata tad QUNTIUL slot 3 on the Apple He 
Memory * Accelerated: Lo bit option 
* Low power consumption tor wathable 


cool operation 


Satisfaction guaranteed! 

Give your Apple the Cee advantage With our risk-free 15 
day mones back guarantee, vou have nothing to lose but wasted 
time Call toda! 

TransWarp Accelerator $ 


279 
lo bit upgrade Cnt add latter) Sat 


) 
For fast response: 

Call Apphed Engineering. 9m. to Ho pan. 7 chavs at e214) 
241-0000, MasterCard, VISA and COD. welcome ‘Texas residents 
ctl S$! 50 sales tan. Add STOOG UF Outside ESL 

Oromai Check or money order to Applied Engineering. POL Bos 
TOR, Carrollton, TX 75006 


Fra. wa Applied Engineering 
The Apple enbancement experts. 


P O. Box 798, Carrollton, TX 75006 (214) 241-6060 
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O8E7=- A5 OD 2860 LDA 
O8E9- 45 OB 2870 EOR 
O8EB- 85 OD 2880 STA 
O8ED- 46 OA 2890 .3 LSR 
O8EF- 66 OB 2900 ROR 
O8F1- 46 OA 2910 LSR 
0 EB 66 OB 2920 ROR 
O8F5=—- A5 OC 2930 LDA 
O8F7- 45 OA 2940 EOR 
O8F9- 85 OC 2950 STA 
O8FB- A5 OD 2960 LDA 
O8FD- 45 OB 2970 EOR 
O8FF- 85 OD 29 STA 

2990 
0901- 88 000 DEY 
0902- DO BY 010 BNE 
0904- 60 3020 RTS 

3030 

O40 TT 
0905- AQ 00 050 LDA 
0907- 85 01 3060 STA 
0909- 85 00 3070 STA 
O90B- 85 09 O80 STA 
O90D- 20 A7 08 3100 .1 JSR 
0910—- A5 05 3110 LDA 
0912- 48 3155 PHA 
0913- 20 00 08 3130 JSR 
0916- 68 3140 PLA 
O917=- C5 05 3150 CMP 
0919— FO 17 3158 BEQ 
091B- 48 ie PHA 

3180 -DO 1 
091C= A5 01 3190 LDA 
O91E=- 20 DA FD 3590 JSR 
0921- A5 00 210 LDA 
0923- 20 OF 08 3220 JSR 
0926—- A5 05 3230 LDA 
0928- 20 9F 08 35 0 JSR 
O92B- 68 250 PLA 
092C- 20 9F 08 3260 JSR 
092F- 20 SE FD ache JSR 

35 0 -FIN 

290 
0932- E6 00 3300 .11 INC 
SB oy He a 
0939- EO 01 3330 INC 
093B=- DO DO 3340 BNE 
093D- 60 3350 RTS 

ae 

Oo # 

3360 # 
093E 00 3100 ia LDA 
OgL0- be 00 3140 STA 
O942- AQ 00 3420 LDA 
O944- 85 01 31 STA 
O946- 20 00 08 3450 .1 JSR 
O949- A5 05 460 LDA 
O94B- 20 67 08 3470 JSR 
O94E- AS nt 3180 LDA 
0950=- C5 0 490 CMP 
0952= A5 01 3500 LDA 
0954- E5 07 3510 SBC 
0956=- 90 2B 520 BCC 
0958- E6 05 530 INC 
O95A- FO 11 3540 BEQ 
095C= A5 05 3550 LDA 
O95E- 20 67 08 3280 JSR 
0961- C6 0 ake DEC 
0963- A5 00 3? 0 LDA 
0965- C5 06 590 CMP 
O3o7- A5 01 3998 LDA 
0969- E5 0 10 SBC 
096B- BO 1 3620 BCS 

3630 


BIT/4 


SUB = SUB .EOR. BIT 


NEWSQR 
ROOT 


SQR 
ROOT 
211 


ARGHI 


ROOT TOO LARGE 


097B- 8D FT 07 


E ED 
D 09 


olelelalelolololeloleyelo 


NM 
H 
= 
Q 


JSR 
JSR 
JMP . 


Updated Memory-vs.-File Maps for ProDOS...Bob Sander-Cederlof 


I am not sure how it happened, but I seem to have botched up 


the table on page 20 of the November 1985 issue. 


understand it, the relationship between the PRODOS file image 


As I now 


(which loads at $2000) and the image of ProDOS after it is 
loaded is as follows (the lines marked with * are the changed 


lines): 


2000-287E 
287F-28FE 
28FF-293C 
293D-29FF 


2A00-2BFF 
2C00-2C99 
2C7F-2CFF 
2D00-4DFF 
4E00-4EFF 
zeroes 

4F00-4F7C 
4F80-4FFF 
5000-56FF 
5700-59FF 


ProDOS Installer Code 


zeroes 
Installer for /RAM Driver 
zeroes 
Aux 200-3FF /RAM/ Driver 
FFOO.FF99 /RAM/ Driver 

zeroes 
DEQO-FEFF MLI Kernel 
BFOO-BFFF System Global Page 
D700-DDFF 
D742-D7BE Thunderclock driver 
FF80-FFFF Interrupt Code 
DOOO-D6FF Device Drivers 


Alt D100-D3FF 


QUIT Code 


Looking at the same information from the viewooint of the 
finished product, here is a map of ProDOS after it is loaded: 


* 
* 


* 
* 


Apple Assembly Line... 


4E00-4EFF 
5000-56FF 
zeroes 

4FO00-4F7C 
2D00-4DFF 
2C00-2C99 
4F80-4FFF 


5700-59FF 


---August, 1986 


BFOO-BFFF System Global Page 
DOOO-D6FF Device Drivers 
D700-DDFF 
D742-D7BE Thunderclock driver 
DEOO-FEFF MLI Kernel 
FFOO-FF99 /RAM/ Driver 
FF80-FFFF Interrupt Code 
Alt D100-D3FF QUIT Code 
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NEW!!! JT INAMAC: $69.00 
This Apple Ii emulator runs DOS 3.3 and PRODOS programs (including 6502 machine language routines) on a 512K 
Macintosh. All Apple Ii features are supported such as HI-RES/LO-RES graphics, 40/80 column text screens, 
language card and joystick. Also included: clock, RAM disk, keyboard buffer, on-screen HELP, access to the desk 
accessories and support for 4 logical disk drives. Package includes 2 MAC diskettes (PROGRAM holds emulation, 
communications and utility software, DATA holds DOS 3.3 and PRODOS system masters, including Applesoft and 
Integer BASIC) and | Apple Il diskette (transfer software moves disk images to the MAC). 


NEW!!! SCREEN.GEN: $35.00 


Develop HI-RES screens for your Apple Ii on a Macintosh. Don't be limited by MousePaint or other screen 
editors. Use MACPAINT (or any other application) on the MAC to create your Apple Il screen. Then use 
SCREEN .GEN to transfer directly from the MAC to the Apple II (with SuperSerial card or equivalent). Package 
includes Apple |! diskette with transfer software plus fully commented SOURCE code. 


NEW!!! MIDI-MAGIC for Apple //c: $49.00 


Compatible with any MIDI equipped music keyboard, synthesizer, organ or piano. Package includes a MIDI-out 
cable (plugs directly into modem port - no modifications required!) and 6-song demo diskette. Large selection of 
digitized QRS player-piano music available for 19.00 per diskette (write for catalog). MIDI-MAGIC compatible 
with Apple II family using Passport MIDI card (or our own input/output card w/drum sync for only $99.00). 


FONT DOWNLOADER & EDITOR: $39.00 


Turn your printer into a custom typesetter. Downloaded characters remain active while printer is powered. 
Use with any Word Processor program capable of sending ESC and control codes to printer. Switch back and 
forth easily between standard and custom fonts. Special printer functions (like expanded, compressed etc.) 
supported. HIRES screen editor lets you create your own characters and special graphics symbols. For Apple Il, 
ll+, //e. Specify printer: Apple Dot Matrix, C.ltoh 8510A (Prowriter), Epson FX 80/100, or OkiData 92/93. 

* The Font Downloader & Editor for the Apple Imagewriter Printer. For use with Apple Il. 
li+, //e (with SuperSerial card) and the Apple //c (with builtin serial interface). 

* FONT LIBRARY DISKETTE #1: $19.00 contains lots of user-contributed fonts for all printers 
supported by the Font Downloader & Editor. Specify printer with order. 


DISASM 2.2e : $30.00 ($50.00 with SOURCE Code) 
Use this intelligent disassembler to investigate the inner workings of Apple I! machine language programs. 
DISASM converts machine code into meaningful, symbolic source compatible with S-C, LISA, ToolKit and other 
assemblers. Handles data tables, displaced object code & even provides label substitution. Address-based triple 
cross reference generator included. DISASM is an invaluable machine language learning aid to both novice & 
expert alike. Don Lancaster says DISASM is “absolutely essential” in his ASSEMBLY COOKBOOK. 
The ‘PERFORMER’ CARD: $39.00 ($59.00 with SOURCE Code) 

Converts a ‘dumb’ parallel printer I/F card into a ‘smart’ one. Command menu eliminates need to remember 
complicated ESC codes. Features include perforation skip, auto page numbering with date & title. Includes large 
HIRES graphics & text screen dumps. Specify printer: MX-80 with Graftrax-80, MX-100, MX-80/100 with 
Graftraxplus, NEC 8092A, C.ltoh 8510 (Prowriter), OkiData 82A/83A with Okigraph & OkiData 92/93. 


‘MIRROR’ ROM: $25.00 ($45.00 with SOURCE Code) 
Communications ROM plugs directly into Novation's Apple-Cat Modem card. Basic modes: Dumb Terminal, 
Remote Console & Programmable Modem. Features include: selectable pulse or tone dialing, true dialtone 
detection, audible ring detect, ring-back, printer buffer, 60 col card & shift key mod support. 


RAM/ROM DEVELOPMENT BOARD: $30.00 
Plugs into any Apple slot. Holds one user-supplied 2Kx8 memory chip (6116 type RAM for program development 
or 2716 EPROM to keep your favorite routines on-line). Maps into $CnOO-CnFF and $CB00-CFFF. 
C-PRINT For The APPLE //c: $69.00 
Connect standard parallel printers to an Apple //c. C-PRINT plugs into the standard Apple //c printer serial 
port and into any printer having a standard 36 pin centronics-type parallel connector. Just plug in and print! 


Unless otherwise specified, all Apple II diskettes are standard (not copy protected!) 3.3 DOS. 
Avoid a $3.00 handling charge by enclosing full payment with order. VISA/MC and COD phone orders OK. 


RAK-WARE 41 Ralph Road W. Orange NJ 07052 (201) 325-1885 
CECECEEEEEEEEEEEEEEEEEEEECEEEEEEEEEEES 
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DUMP Command for DOS Big Desi wie ear eee COWS CAE eee Morgan 


Back in March, 1984 Bob S-C wrote up a modification to the DOS 
VERIFY command processor to make that command do a hex dump of 
a file. This can be a very useful tool, giving us the ability 
to see exactly what's stored in any file of any type, so of 
course I wanted to include it in the DOS I've been building for 
the UniDisk 3.5. In his version Bob provided a 40-column hex- 
only display and invited the reader to expand it to 80 columns 
with ASCII as well. That's what I've done here, as well as 
adding pause and abort features. I didn't get as far as his 
Suggestion to allow paging through the file either backwards or 
forwards, so there's still something left for you tinkerers. 


As written here DUMP runs in 158 bytes of page 3. I got 
involved in making it better, rather than making it smaller, so 
it still won't fit inside of DOS yet. Maybe next time around. 


There 1S a side effect of modifying VERIFY. Both SAVE and 
BSAVE call VERIFY after they're done, to make sure all went 
well. The first time I got this patch working and then SAVEd 
the file I got a nice dump all over the screen at the end of 
the SAVE. That's why I ended up having the DUMP command call a 
little routine that patches into the VERIFY code, calls it, and 
then de-patches itself. This means that if you RESET out of a 
DUMP, or if you get an I/O ERROR, the DUMP patch will still be 
in place and you'll probably want to disconnect it. You can do 
that either by doing a successful DUMP command, or by calling 
the disconnect routine directly ($329G or CALL 809). 


So, on to the code. By the way, I use a couple of 65C02 
opcodes in this program, but the equivalent 6502 instructions 
are shown {in curly brackets} in the comment field. 


INSTALL points the command vector to my routine and changes the 
command name from VERIFY to DUMP. Normally when you change a 
DOS command name the new name must have the same number of let- 
ters as the old one, but since VERIFY is the last name in the 
list we can truncate it and fill the ending bytes with zeroes. 


PATCH is called when we type the DUMP command. Here we patch 
into the VERIFY processor to call DUMP in place of the call to 
get the next sector of the file. It then calls VERIFY as usual 
and then puts it back, This way we can get the sector and 
display it when it's our command, but leave the normal VERIFY 
operation undisturbed so SAVE and BSAVE can function normally. 


DUMP first does the GET.SECTOR call we patched in over, exiting 
when we hit the end of the file. The next step is to prepare 
the display so we print a blank line and display the relative 
sector number in the file. Note that this is not a disk track 
Or sector number; this is the position in the track/sector 
list. We then set the Y-register to the beginning ot the 
sector buffer and branch into the code to display one line. 


The line display routines starting at line 1600 normally begin 


by printing four spaces to allow for the sector number printed 
on the first line. After that we print the offset into the 
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sector from the Y-register and a separating daSh. Notice that 
the PRINT.BYTE and PRINT.DASH routines also output a trailing 
Space. Now it's time to get the next 16 bytes from the file, 
stash them in a buffer for later ASCII printing, ana display 
them in hexadecimal. (The stash buffer is inside the secondary 
filename buffer, which is used only during a RENAME commana.) 
The odd code in lines 1730-1780 has the effect of printing an 
extra Space after every four bytes, to separate the display 
into columns and improve readability. 


The last steps in displaying a line are to recover the 16 bytes 
from the buffer, make them printable and replace any control 
characters with underlines, and send them on out. (Most 
programs seem to replace control characters with periods, but I 
chose the underline so I could more easily see the real periods 
in the file. Underlines are much rarer in typical text.) 

After that we check the keyboard for a pause or abort and check 
to see if we've finished the sector yet. If necessary we 
branch back and do the next line. 


PAUSE is lifted straight from the SHOW command article in AAL 
July, 1982. As a matter of fact, since I always install SHOW I 
just call PAUSE at SAE8E rather than including it in DUMP. 

This is a very useful routine tq keep around, 


1000 *SAVE S.DUMP 


1010 -OP 65C02 
De ke Sr ne ery ere 
1040 # Patch DOS to change 
1050 * VERIFY into DUMP 
105 ¢ 
h2- 1080 POINTER ~-EQ $42 
9D54- 1090 VECTOR ~EQ $9D54 
A27D- 1100 VERIFY ~-EQ $A27D 
A902- 1110 VFY.NAME ~-EQ $A902 
AAAO- 1120 BUFFER EQ $AAA0 
AD1C- Te READ.CALL .EQ $AD1C 
BOB6- 1140 GET.SECTOR .EQ $BOB6 
B5E4- 1150 SECTOR -EQ $B5E4 
CO00- 1160 KEYBOARD -EQ $C000 
C010—- ithe STROBE ~-EQ $C010 
FQ41- 1180 MON.PRNTAX .EQ $F941 
FO4A- 1190 MON.PRBL2 .EQ $F94A 
FD8E- 1200 MON.CROUT .EQ $FD8E 
FDDA- 1210 MON.PRBYTE .EQ $FDDA 
FDED- ieee MON . COUT ~-EQ $FDED 
15h -OR $300 
ieee ~TF B.DUMP 
0300- AQ 03 a INSTALL LDA /PATCH-1 point DOS vector table 
0302= 8D 55 9D 1280 STA VECTOR+1 to my patch 
0305- AQ 1B 1290 LDA #PATCH-1 
Sao- a &8 2 1393 Ek geo 
030C- BD 16 03 1320 .1 LDA COMMAND, X change VERIFY command 
O30F- 9D O02 AX 1330 STA VFY . NAME, X name to DUMP 
0312- CA 1300 DEX 
0313- 10 FT 1350 BPL .1 
S818 SE os up 1900S 
0319=- DO 1320 COMMAND .AT /DUMP/ 
031A=- 00 00 BO . ~HS 0000 
031C= AQ 34 1800 PATCH LDA #DUMP hook into VERIFY command 
Gaaie a8 dg © 13 ER bay cat 
0323- 8D 1D AD aes STA READ.CALL+1 
0326- 20 7D A2 1440 JSR VERIFY call it 
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0329= AQ B6 We LDA #GET.SECTOR restore normal VERIFY 
032B- 8D 1C AD 1460 STA READ.CALL ; 
032E=- AQ BO Una LDA /GET.SECTOR 
0330- 8D 1D AD 1480 STA READ.CALL+1 
0333- 60 pe . RTS 
0334= 20 B6 BO 1510 DUMP JSR GET.SECTOR read next sector 
0337—- BO 59 1520 BCS .7 end of file 
03327 20 8E FD ie JSR MON .CROUT start sector with <CR> 
0 - E5 B5 1540 LDA SECTOR+1 
033F- AE E4 B5 1550 LDX SECTOR 
0342- 20 41 FQ 1560 JSR MON .PRNTAX display sector position 
0345 AO 00 120) LDY #0 start at beginning of sector 
O347=- FO 05 1260 BEQ .2 -ee always 
0349=- A2 O04 1600 .1 LDX #4 print 4 blanks 
‘ hee 5 HA FQ Leu 5 ak MON . PRBL2 so columns look neater 
O34F- 20 9B 0 19 30 : JSR PRINT.BYTE print byte count 
0352= 20 94 03 1640 JSR PRINT.DASH separator 
0355- A2 OF 1650 LDX #12 16 bytes per line 
0357- B1 42 1660 .3 LDA (POINTER),Y get byte from file 
0359= 9D AO AA ee. STA BUFFER, X stash it 
035C- 20 9B 03 1680 JSR PRINT.BYTE print as hex value 
53202 CA 1780 DEX sable: se 
0361- 30 OB ye BMI .4 done with this line? 
030 - BA is%6 TXA gheck ; 
0364- 1A 1740 INC EOR #%00000011} 
0365- 29 03 1750 AND #%00000011 
0367- DO EE 1760 BNE .3 every fourth byte 
0302 - 20 JE 03 he JSR PRINT. SPACE skip a_space 
036C- 80 £9 Vee BRA .3 {JMP . 3} 
036E=- 20 94 03 1$80 4 JSR PRINT.DASH separator 
0371- Ae OF 1810 LDX #15 16 bytes 
0373- BD AO AA 1820 .5 LDA BUFFER ,X get stashed value 
0 q as 09 80 1830 ORA #410006000 hi-bit on 
037A- BO 02 1850 BCS . filter out controls 
037C=} AQ DF 1860 LDA #"_" substitute "%_" 
33 as a ED FD (aie 6 ety MON .COUT print as ASCII 
0382- 10 EF 1890 BPL .5 back for more 
0384- 20 BE FD 1910 JSR MON .CROUT next line 
FE 20 03 oe ack PAUSE pheen .fOr pause or 
= EQ . abor 
ie Se Be 1840 oy i done with sector? 
= N e 

Aeone Ly Wen oLe normal exit 
0392- 38 1880 7 SEC EOF or abort exit 
0393= 60 a " RTS 

2010 PRINT.DASH 
0394—- AQ AD 2020 LDA #"-" 
0396- 20 ED FD 2030 JSR MON .COUT 
0399- 80 03 - eee pune PRINT.SPACE {JMP PRINT.SPACE} 
039B- 20 DA FD 2060 PRINT, SeorgttON -PREYTE 
039E- AJ AO  —-2080 “LDA #” 1" 
03A0- 4C ED FD eso ‘ JMP MON.COUT 

2110 # RETURN .EQ. IF ABORT 

5150 : ~NE. IF CONTINUE 
03A3=- AD 00 CO 5186 PAUSE LDA KEYBOARD any key pressed? 
O3A6—- 10 11 2150 BPL .2 no, continue 
O3A8- 8D 10 CO 2160 STA STROBE yes, clear strobe 
O3AB- CQ 8D 2170 CMP orey abort? 
O3AD- FO OA 2180 BEQ . yes, return .EQ. status 
O3AF= AD 00 CO 2190 .1 LDA KEYBOARD no, pause ‘til keypress 
03B2= 10 FB 2200 BPL .1 none pressed yet 
O3B4- 8D 10 CO 2210 STA STROBE clear strobe 
O3B7- C9 8D 2220 CMP #$8D abort? 
O03B9- 6 2230 .2 RTS -EQ. if abort 
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RamWorks IIT 


The Best Selling Memory Card for the Apple Just Got Even Better! 


With battery backed RAM port RGB port increased memory capacity, full software 
compatibility and more compact design, RamWorks III is a generation ahead 


RamWorks Ill is the newest 3rd 
generation RAM card for the Apple Ie. It 
incorporates all of the technology and 
improvements that years of experience 
and over a hundred thousand sales have 
given us. By selling more memory cards 
than anyone else and listening to our 
customers, we were able to design a 
memory card that has the ultimate in 
performance, quality, compatibility and 
ease of use. We call it RamWorks IIL 
you'll call it awesome! 


The AppleWorks Amplifier. 

While RamWorks III is recognized by 
all memory intensive programs, NO 
other expansion card comes close to 
offering the multitude of enhancements 
to AppleWorks that RamWorks III does. 
Naturally, you’d expect RamWorks III to 
expand the available desktop, after all 
Applied Engineering was a year ahead of 
everyone else including Apple in offering 
more than 55K, and we still provide the 
largest AppleWorks desktops available. 
But a larger desktop is just part of the 
story. Look at all the AppleWorks en- 
hancements that even Apple’s own card 
does not provide and onfy RamWorks III 
does. With a 256K or larger RamWorks 
IIL, all of AppleWorks (induding printer 
routines) will automatically load itself into 
RAM dramatically increasing speed by 
eliminating the time required to access 
the program disk drive. Switch from 
word processing to spreadsheet to data- 
base at the speed of light with no wear 
on disk drives. 

Only RamWorks eliminates Apple- 
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Works’ intemal memory limits, increasing 
the maximum number of records avail 
able from 1,350 to over 25,000. Only 
RamWorks increases the number of lines 
permitted in the word processing mode 


from 2,250 to over 15,000. And only 


in printer buffer, so you won't have to 
wait for your printer to stop before 
retuming to AppleWorks. RamWorks 
even expands the dipboard And auto 
segments large files so they can be saved | 
on two or more disks You can even 
have Pinpoint, MacroWorks or Jeeves 
and your favorite spelling checker in 
RAM for instant response. 

RamWorks, nothing comes close to 
enhancing AppleWorks so much. | 


The Most Friendly, Most | 
Compatible Card Available. 


Using RamWorks III couldn't be easier 
because it's compatible with more off 
the-shelf software than any other RAM 
card. Popular programs like AppleWorks, | 
Pinpoint, Catalyst, MouseDesk, Howard- : 
Soft, FlashCalc, The Spread Sheet, Manag- | 
ing Your Money, SuperCalc 3a, and Magi- | 
Calc to name a few (and all hardware 
add on’s like ProFile and Sider hard | 
disks). RamWorks is even compatible 
with software written for Apple cards. But : 
unlike other cards, RamWorks plugs into 


RamWorks (256K or larger) offers a built- | 
| 
| 


the Ile auxiliary slot providing our super 
sharp 80 column text in a completely 
integrated system while leaving expan- 
sion slots 1 through 7 available for other 
peripheral cards. 

RamWorks III is compatible with all 


| 
| 
| 


Apple Ile’s, enhanced, unenhanced, 
American or European versions. 


Highest Memory Expansion. 
Applied Engineering has always of- 
fered the largest memory for the IIe and 
RamWorks III continues that tradition by 
expanding to 1 full MEG on the main 
card using standard RAMs, more than 
most will ever need (1 meg is about 500 
pages of text)...but if you do ever need 
more than 1 MEG, RamWorks III has the 
widest selection of expander cards avail- 
able. Additional 512K, 2 MEG, or 16 
MEG cards just snap directly onto Ram- 
Works III by plugging into the industry's 
only low profile (no slot 1 interference) 
fully decoded memory expansion con- 
nector. You can also choose non-volatile, 
power independent expanders allowing 
permanent storage for up to 20 years. 


It Even Corrects Mistakes. 


If you've got some other RAM card 
that’s not being recognized by your 


| Programs, and you want RamWorks IIL, 


you're in luck Because all you have to 
do is plug the memory chips from your 


, Current card into the expansion sockets 


on RamWorks to recapture most of your 
investment! 


The Ultimate in RGB Color. 

RGB color is an option on RamWorks 
and with good reason. Some others 
combine RGB color output with their 
memory cards, but that’s unfair for those 
who don’t need RGB and for those that 
do. Because if you don’t need RGB 


Applied Engineering doesn’t make you 
buy it, but if you want RGB output 
you're in for a nice surprise because the 
RamWorks RGB option offers better 
color graphics plus a more readable 80 
column text (that blows away any 
composite color monitor). For only $129 
it can be added to RamWorks giving you 
a razor sharp, vivid brilliance that most __ | 
claim is the best they have ever seen 
You'll also appreciate the multiple text 
colors (others only have green) that 
come standard But the RamWorks RGB | 
option is more than just the ultimate in 
color output because unlike others, it’s 
fully compatible with all the Apple 
standards for RGB output control, mak- 
ing it more compatible with off the-shelf 
software. With its FCC certified design, 
you can use almost any RGB monitor 
because only the new RamWorks RGB 
option provides both Apple standard and 
IBM standard RGB outputs (cables in- | 
cluded). The RGB option plugs into the 
back of RamWorks with no slot 1 inter- | 
| 


RGB Option 


ference and remember you can order 
the RGB option with your RamWorks or 
add it on at a later date. 


True 65C816 Bit Power. 
RamWorks III has a built-in 65C816 
CPU port for direct connection to our 
optional 65C816 card. The only one 
capable of linearly addressing more than 
1 meg of memory for power applica- 
tions like running the Lotus 1-2-3” 
compatible program, VIP Professional 
Qur 65C816 card does not use another 
-slot but replaces the 65C02 yet maintains 
full 8 bit compatibility. 


; power and speed that it adds to any Le. 


Endorsed by the Experts. 

A+ magazine said “Applied Engineer- 
ing’s RamWorks is a boon to those who 
must use large files with AppleWorks...I 
like the product so much that I am 
buying one for my own system.” inCider 
magazine said “RamWorks is the most 


‘T wanted a 
memory card for 
_ my Apple that was 
_ fast, easy to use 
and very compat. 


ible; so I bought 
RamWorks.” 


Steve Wozniak, the creator 
of Apple Computer 


powerful auxiliary slot memory card 
available for your Ile, and I rate it four 
stars..For my money, Applied Engineer- 
ing’s RamWorks is king of the hill” 
Apple experts everywhere are im- 
pressed by RamWorks’s expandability, 
versatility, ease of use, and the sheer 


With a RamWorks in your Apple, you'll 
make IBM PC's and AT’s look like 


slowpokes. 


Quality and Support of the 
Industry Leader 

RamWorks III is from Applied Engi- 
neering, the largest, most well supported 
manufacturer of Apple peripherals and 
the inventor of large RAM cards for the 
Apple. With our 5 year no hassle 
watranty and outstanding technical sup- 
port, you're assured of the most trouble 
free product you can buy. 


Its Got It All 
e 15 day money back guarantee 
e 5 year hassle free warranty insures 
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coverage no matter where you 
purchase 

Built-in super sharp 80 column display, 
(with or without RGB) 

e Expandable to 1 MEG on main card 
e Expandable to 16 meg with expander 
card, with NO slot 1 interference 

e Can use 64K or 256K RAMs 

e Powerful linear addressing 16 bit 
coprocessor port 

Automatic AppleWorks expansion up 
to 3017K desktop 

e Accelerates AppleWorks 

e Built-in AppleWorks printer buffer 

e The only large RAM card that’s 100% 
compatible with all Ile software 
RamDrive™ the ultimate disk emula- 
tion software induded free 

Memory is easily partitioned allowing 
many programs to be in memory at 
once 

Compatible, RGB option featuring ultra 
high resolution color graphics and 
multiple text colors, with cables for 
both Apple and IBM type monitors 
Built-in self diagnostics software 
Lowest power consumption (patent 
pending) 

Takes only one slot (auxiliary) even 
when fully expanded 

Socketed and user upgradeable 
Software industry standard 

Advanced Computer Aided Design 
Used by Apple Computer, Steve 
Wozniak and virtually all software 
companies 

Displays date and time on the Apple- 
‘Works screen with any PRO-DOS 
compatible clock 

Much, much more! 


RamWorks Ill with 64K 
RamWorks Ill with 256K 
RamWorks Ill with 512K 
RamWorks Ill with 1 MEG 
RamWorks Ill with 1.5 MEG 
RamWorks lll with 2 to 16 MEG 
65C816 16 Bit Card 

RGB Option 

256K Upgrade 


$179 
$219 
$269 
$369 
$539 
CALL 
$159 
$129 
$ 50 


RamWorks IIL The industry standard 
for memory expansion of the Apple Ile. 
ORDER YOUR RamWorks II] TODAY. 
9 am to 11 pm 7 days, or send check 
Or money order to Applied Engineering 
MasterCard, Visa and COD. welcome. 
Texas residents add 5%% sales tax. Add 
$10.00 if outside USA 


y= Applied Engineering 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 
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Compatibility with the Laser-128..........Bob Sandaer-Cederlot 


We borrowed a Laser-128 (popular clone of the Apple //c) the 
Other day. It had been rumored that our software would not run 
on it, in spite of Central Point Software's sanguine claims. 
Sure enough, the S-C Macro Assembler would not operate, under 
either DOS or ProDOS. They boot and load, but no more. 


A little investigation revealed what we expected: our software 
uses at least a half-dozen entry points into the Apple monitor 
which are not supported in the Laser-128 monitor. Most of them 
have to do with our "S$" command, which lets you perform monitor 
commands without leaving the S-C environment. These patches 
will disable the "S$“ command and repair the "MEM" command, The 
addresses shown are for our current release disks. 


DOS 3.3 $1000 version 1AE6:4C B3 1B 20 40 F9 AY AD 4C ED FD 
124A:E9 1A (was 99 FD) 
125D:E9 1A (was 99 FD) 


DOS 3.3 $D000 version DAE6:4C B3 DB 20 40 F9 AQ AD 4C ED FD 
D24A:39 DA (was 99 FD) 
D25D:E9 DA (was 99 FD) 


ProDOS version 8B45:4C 24 8C 20 40 F9 AJM AD 4C ED FD 
8450:48 8B (was 99 FD) 
8463:48 8B (was 99 FD) 


Make a backup copy of the disk, and then boot the backup copy. 
When the assembler version you choose has loaded, type the 
letter X and the RETURN key. This should BRK out of the 
assembler into the Laser-128 monitor. Make the patches as 
shown above, and then type “3D0G" or control-RESET to get back 
into the assembler. [It should be working correctly now. If 
you are fixing the DOS 3.3 version, you can now BSAVE the 
patched code on the file you originally loaded. 


If you are fixing the ProDOS version, you now should BLOAD the 
type SYS file called SCASM.SYSTEM. The same patches you just 
Made to the assembler should now be applied to the image orf the 
SYS file, and then BSAVE the image on the disk: 


:BLOAD SCASM. SYSTEM, TSYS,A$2000 

:MNTR 

*2D45:4C 24 8C 20 40 F9 AYX AD 4C ED FD 
*2650:48 8B 

*2663:48 8B 

*3D0G 

:BSAVE SCASM.SYSTEM, TSYS,A$2000,L17920 


One incompatibility remains for which we never tound the cause: 
the esc-L shorthand command, to turn a CATALOG line into a LOAD 
command, does not work in 80-column mode. It does work just 
fine in 40-column mode. If any of you try these patches and 
find other problems, we would like to hear about them. 


One more item: we found the LasSer-128 monitor incorrectly 
disassembles the PLX command as PHX. 
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The first clock 
card to add time 
and date to | 
AppleWorks’ 
screens and files. 


Timemaster H.O. So many 
features its become the worlds 
best selling clock card. 


ts the smart wan to put the time and ditte on vour Apple 

He* or fh+ © Because onl the Timemaster PEO: packs 
ALL the important teatures of all the competition combuied. 
including leap vear vear Cnot just my PRO DOS) month, 
dite. day of week, hours. minutes. seconds and milli 
seconds. [ts tot PRO-DOS. DOS 3.3. PASCAL and CPM 
compatible. And. of course. it works better than any other 
clock with AppleWorks. 

With the Timemiuster HO. vou re assured of reliable. 
trouble-free operation along with simple. one-command 
time setting. accuracy through leap vears. and a firmware 
maintained: terruptl setung. 

If vou re using or writing software for other clock 
cards. voure still covered) Because the HO. will aadomat 
ically emulate them. And only the Timemaster HELO. adds 15 
new commands to BASIC. The H.O. even comes complete 
with two disks full of sample programs, including a comput: 
crized appointment book. a DOS dating program, interrupt 
programs. and over 30 programs thatothers charge vou 
extra for - or don teven offer, As a low-cost option, vou 
can add true BSR remote control to the FLO. giving vou 
remote control of up to 16 lights and appliinces i vour 
home or office. 


* Time in hours, minutes, seconds and milliseconds. date 
with vean month. day of week and leap veare 24-hour 
military format or 12-hour AM PM tormat® Eight software 
controlled interrupts so vou can run Ovo programs at the 
sume time (many examples included) * Can be set to the 
second * Allows AppleWorks to time and date stump all data 
automatically * Displays time and chute on AppleWorks 
screens and files * Five-wear warranty 
Timemaster HO... ... .. .. 
BSR option (may be added later ) 


$129.00 
$ 49.00 


Call to order today, 9 atm) to TH p.m. seven days, or 
send check or money order to Applied Engineering. Master: 
Card, VISA and C.O.D. welcome. Texas residents add 5! s°% 
sales tax. Add $10.00 outside ULS.A. 


Va. wa Applied Engineering 
The Apple enhancement experts. 


P O. Box 798, Carrollton, TX 75006 (214) 241-6060 
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Vieumaster SO 


Now run 
AppleWorks on 
your IT+and keep 
full 80 column 
compatibility! 


jMiewmasTeRso| . | . |. |. [. [. |. |. ff 
pscprTerM TTT 

peazarn eo TT 

[Mision vo TT 

pomnpysion TT 

parwneaxno Tt 
SMARTERM ae ee, a FE a FF 
Mpgorerm TT TT. ET 


() ne look at the chart will give vou some of the 
reasons theres only one smart choice in 80 
column cards for your Apple. But the real secret to 
Viewmaster 80's success is something even better: 
Total compatibility. 

Each Viewmaster 80 includes our powerful Apple- 
Works expand software, allowing AppleWorks to run on 
the If+ with only 64K (or more) memorn. (We recom- 
mend the RamFactor memory card, but any compatible 
Apple memory card will work.) The software provides 
our full range of AppleWorks enhancements, including 
expanded records, word processor, multi-disk saving, 
time and date display on screen with any PRO-DOS 
clock, and more! 

The Viewmaster 80 works with all 80 column 
applications, including DOS 3.3, PRO-DOS, CP/M, 
Pascal, WordStar, Format I, Applewriter H, dBase 1], 
Visicalc, Multiplan, and hundreds of others — includ- 
ing AppleWorks. 

Here are just a few of the powerful features the 
Viewmaster 80 delivers for a great price ($139): 

° 80 Characters by 24 lines * Fully compatible with all 
Apple languages and software * Highest compatibility 
with existing 80 column software * Very low power con- 
sumption * High speed (18 MHZ) scroll rate * Upper and 
lower case characters and true descenders, both inverse 
and normal; all on-screen editing functions are sup- 
ported ¢ User-definable cursor shape * Compatible with 
Apple II, I+ and He « Five-year warranty 

Call today to order or for more information, 9 a.m. 
to 11 p.m. seven days, or send check or money order to 
Applied Engineering. MasterCard, VISA and C.O.D. wel- 
come. Texas residents add 5%% sales tax. Add $10.00 
outside U.S.A. 


Vas wa Applied Engineering 
P.O. Box 798, Carrollton, TX 75006 
(214) 241-6060 


Convert Lo-Res Pictures to Double Hi-ResS.....David C. Johnson 
(with Info about Two Secret RGB Modes) 


In the January '86 AAL, Bob presented a routine to convert lo- 
res to regular hi-res. He pointed out that "it is not possible 
to exactly reproduce the lo-res colors on the hi-res screen 
(unless I used //e or //c double hi-res)." Bob's routine used 
patterns to "come close to the same color." He also wrote that 
he didn't have a color monitor and didn't know how close he 
got. I have an RGB color monitor, and patterns result in most 
unsatisfactory conversion. This article offers three satis- 
factory conversion routines that, of course, use double hi-res. 


Regular color double hi-res, which will work ona color TV, a 
composite color monitor, or an RGB monitor (mode 2 or 3), has a 
resolution of 140 by 192. Lo-res has a resolution of 40 by 48. 
Since 140 is not evenly divisible by 40, regular color double 
hi-res is not capable of displaying a satisfactory 
representation of a lo-res picture. You can reproduce all 
sixteen colors, but you can't get satisfactory resolution of 40 
lo-res columns. An RGB monitor, driven by an AppleColor (or 
compatible) card, can display a PERFECT double hi-res version 
of a lo-res picture two different ways. Two of my routines 
perform these color conversions and work ONLY for RGB. Without 
RGB they look lousy. The third routine, included for 
completeness, performs a monochrome conversion and will work on 
an RGB monitor (mode 1) or a monochrome monitor. 


I'm writing this article so I may present examples of how the 
RGB-only video modes work. The two color routines use modes 
that are not described in the AppleColor card manual. The 
AppleColor card comes with demo disks that show foreground/ 
background hi-res; a Video-7 demo disk I have shows "160 Mode". 
Except for these two simple demos and a collection of programs 
which I have written, I know of no programs, commercial or 
otherwise, uSing these modes. By the way, while I do have a 
//c, I don't have an RGB interface for it, so I don't know if 
Video-7's (or anyone else's) //c RGB Adapter supports these 
modes Or 1S compatible with the AppleColor card. I would be 
interested in hearing from any of you on these subjects at: 41 
Putnam Park Road, West Redding, CT 06896. 


F/B hi-res works much like monochrome regular hi-res. Main 
memory bytes define the screen at seven pixels each (bit 7 is 
ignored - no half shifting), but instead of each 1 bit 
producing an "on" pixel and each 0 bit an “off" pixel, each 1 
bit produces a “foreground" pixel and each 0 bit a "background" 
pixel. Auxiliary memory bytes define the F/B colors of the 
seven pixels at the same address in main memory. The high 
nybbles contain the foreground colors and the low nybbles the 
background colors. For example, aux $2000:12 and main $2000:55 
would produce magenta, dark blue, magenta, dark blue, magenta, 
dark blue, and magenta beginning at the top left. In effect 
you get 280x192 resolution with sixteen colors! Of course, 
Since F/B colors are defined for each group of seven pixels, 
not each pixel, you can only get two colors per seven pixels. 


With “160 Mode", the "given" of using only seven bits of every 
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byte for pixel information is gone. All eight bits of both the 
auxiliary and main memory pages are used. It seems (to me) to 
be more closely related to lo-res than hi-res, only “sideways" 
and with sixteen times the resolution. Low nybbles define the 
even columns and high nybbles the odd columns, while in lo-res 
the correspondence is between nybbles and rows. Auxiliary 
memory pairs precede main memory pairs. For example, aux 
$2000:21 and main $2000:43 would produce: magenta, dark blue, 
purple, and dark green beginning at the top left. Effective 
resolution is 160x192 with sixteen colors and no restrictions! 


Both the RGB modes offer superior pictures compared to regular 
hi-res and (regular) double hi-res. They also offer other ad- 
vantages important to programmers. We can manipulate F/B 
hi-res images pixel data separately from the color data. "160 
Mode" images can be drawn in 80 different horizontal positions 
without any shifting, and the other 80 are only a 4 bit shift 
(or look up) away uSing whole bytes. Best of all, the bits 
that define a colored pixel don't ever fall in different pytes! 


The three routines may be tested by entering at labels "a", “b" 
and "c". These are extensions the demo "T" in Bob's program. 

I have also kept his "PLOT" and “PAUSE.FOR.ANY.KEY" routines. 
I've rearranged Bob's code to handle some //e (and //c) stutf, 
the double hi-res video modes, etc. You should refer back to 
his article, and compare our code. One thing that I didn't 
Carry forward from Bob's code is his stepping through the 
screen memory uSing CarteSian coordinates. My routines crank 
along sequentially. The video mode switching is all handled by 
these test routines, 


F/B mode is active any time the 80 column Switch is off and 
annunciator 3 is off. The other double hi-res RGB modes are 
activated by clocking two data bits and a "1" bit into a shift 
register on the AppleColor card. The value of the data bits 
determine which mode is activated. The data bits and the "1" 
bit are the setting of the 80 column switch at the time the 
shift register is clocked. The shift register is clocked by 
lowering the annunciator 3 switch. 


ConvertLoReSToFBHiRes first sets the main memory pixel buffer 
to a pattern of 24 black horizontal regions (0, “ort") with 24 
white bars (1, “on") interspaced., The "off" (excuse me, 
background) areas correspond to the even lo-resS rows, anda the 
“on" (foreground) to the odd rows. This works out to filling 
main $2XXX w/S$00 and main $3XXX w/S7F. By uSing this pattern, 
I avoided having to manipulate the lo-res data before storing 
it in auxiliary memory. To understand this you must remember 
that even lo-res rows are stored in low nybbles and odd lo-res 
rowS in high nybbles. After setting up main memory, the lo-res 
data is expanded 8:1 into the auxiliary memory color buffer. 
For example: $400 gets copied to aux $2000, $2400, $2800, 
$2C00, $3000, $3400, $3800, and $3C00. If this is viewed ona 
non-RGB monitor, all you'll see is 24 bars. 


ConvertLoResToDoubleHiRes1l60 expands the lo-res data nybbles 


16:1. Each lo-res byte is split into low and high nybbles. 
Each nybble is in turn duplicated in the other half of 8 bits 
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and then copied into the main and auxiliary memory locations 
that correspond to the lo-res pixel the nybble used to be. For 
example: the low nybble of $400 gets copied to both nybbles of 
aux $2000, $2400, $2800, $2C00, and main $2000, $2400, $2800, 
$2C00; the high nybble of $400 gets copied to both nybbles of 
aux $3000, $3400, $3800, $3C00, and main $3000, $3400, $3800, 
$3c00. If you look at this on a monochrome monitor you'll see 
only 7/8ths of the data; it looks strange. Viewed on a non-RGB 
color screen, you'll get a mess of wrong colors. 


The last routine, ConvertLoResToDoubleHiRes560, draws double 
hi-res monochrome patterns (NOT color patterns). I carefully 
studied the patterns lo-res makes when viewed on a monochrome 
monitor, writing down the constituent binary numbers. From 
that, I typed in the table "Monos", extending the patterns to 
include both even and odd offsets, and dividing them into 
auxiliary and main bytes. Once the table was defined, the 
routine just fell together (“automatically")! It uses each 
nybble and its Y-index LSB (NOT its Y-coord, but it works) to 
look up patterns from "Monos", and stores them into double 
hi-res memory. 


If you would like to look at an attempt to convert lo-res to 
regular color double hi-res, you can change the monochrome 
routine to perform in color. First you should move the STA 
Column800n in “c" up four lines so that it is before the first 
STA AN30ff instead of the last one. This turns on mode 2 in- 
stead of mode 1. You will also need to include two more lines 
in subroutine ".2" of "ConvertLoResToDoubleHiRes560", and adda 
small table. I would put the table just before “Monos", 
Because the sample colors drawn by “Plot" (being 4 pixels wide) 
do convert correctly, be sure that there is a lot of text on 
the screen when you run the modified code. Change as follows: 


oe TAX 

LDA Spin,X 

ROL (.2 moved up trom this line) 
»--rest of S/r... 
Spin >hs 00.08.01.09.02.0A.03.0B 

>hs 04.0C.05.0D.06.0E.07.0F 


I've put the F/B hi-res mode to use many times to run programs 
like Asteroid Field (an oldie, but a goodie) and MousePaint on 
my RGB monitor. These programs were intended to be viewed ona 
monochrome monitor and, without help, they display unintended 
colors on RGB. By setting up F/B hi-res to display white on 
black (grey on brown looks good too) and then booting, I save 
having to turn on the monochrome NEC and turning my head to the 
left while playing (or painting). Here's how: 


*C001:0 N C055:0 N C057:0 N 400:FO N 401<400.4000M 
C005:0 N 4000<2000.4000M C004:0 N 
C054:0 N C000:0 N CO5E:0 N 6°P 

Or *1/400:f£0 n 1/401<1/400.6000m cO05e 6”p (EDM ONLY) 


These Monitor commands also write auxiliary text page 1. This 
is because there is a F/B 40-column text mode too! 
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1010 *SAVE S.Lo.to.HiRes 

26- 1020 LBas -eq $26,$27 
2h- song HBas -e€q $2A,$2B 
2E- 1040 ctr feq $2E,$2F111 
30- 1050 Color -eq $30 
C000- 1060 Store800ff -eq $C000 
CO01- ee Store800n -eg $C001 
COOC= 1080 Column800ff -eq $COO0C 
COOD- 1090 Column800n ~eq $COOD 
CO1F- 1100 ReadColumn80 -eq $CO1F 
CO54- 1110 MainPage -eq $C054 
C055- 1120 es -eq $C055 
CO5E- ae AN30f -eq $CO5E 
CO5F- : AN30n -eq $CO5F 
0800- 20 80 09 1120 a JSR Plot 
0803- 48 We PHA save 40/80 state 
O804=- 20 66 08 1180 .1 JSR Pause2 
0807- 8D 5E CO 1190 STA pipe (double (?) hi-res on) 
O80A- AD 57 CO 1200 LDA $C057 hi-res (RGB F-B Hi-Res) 
es sp ef a8 an Jor pouvere Loken tobbla tee 

- ause 
0813- DO EF Lt P BNE .1 branch always 
0815=- 20 80 09 1250 b JSR Plot 
0818- 48 1260 PHA save 40/80 state 
0819~ 20 66 08 ich 1 JSR Pause2 
081C- 8D OD CO 1280 STA Column800n RGB MODE "4" 
O81F- 8D 5E CO 1290 STA AN30ff (160 Res 16 Color 
0822= 8D 5F CO 1300 STA AN30n Double Hi-Res) 
0825= 8D OC CO 1336 STA Column800ff 
Sak 2k 1g SH Se 

- n 
O82E- 8D OD CO 1340 STA Column800n 
0831- 8D 5E CO 1350 STA AN30ff (double hi-res on) 
O834- AD 57 CO 1360 LDA $C057 hi-res 
ee 20 oH a 1378 Jan ponies vhoneatepour tenance leu 
O83A= 20 7 ause 
083D=- DO DA 1390 : BNE .1 branch always 


NEW FROM 
DON LANCASTER 


HANDS-ON BOOKS UNLOCKED @ SOFTWARE 


Apple Assembly Cookbook 21.50 Absolute Reset lle & lic 19.50 
All About Applewriter 12.50  Applewriter Toolkit (Dos 3.3e) 39.50 
Applewriter Cookbook 19.50 § Applewriter Toolkit (ProDOS) 39.50 
Enhancing your Apple vol | 15.50 Both Applewriter Toolkits 59.50 
Enhancing your Apple vol Il 15.50 § Applewriter/Laserwriter Utilities 39.50 
Micro Cookbook vol | 15.50  Laserwriter Demo Pack FREE 
Micro Cookbook vol Il 15.50 | Appleworks Disassembly Script 49.50 


CMOS Cookbook 14.50 Enhance vol! Companion Disk = 19.50 
TTL Cookbook 12.50 Enhance vol ll Companion Disk 19.50 
TV Typewriter Cookbook 12.50 Assembly CB Companion Disk 19.50 
Active Filter Cookbook 14.50  Applewriter CB Companion Disk 19.50 
Incredible Secret Money Machine 7.50 Classic Cell Animation Demo 12.50 


FREE VOICE HELPLINE VISA/MC 


SYNERGETICS 
Box 809-SC 
Thatcher, AZ 85552 
(602) 428-4073 
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ae 

3 c07e C.. 

PHA save 40/80 state 
| JSR Pause2 


STA AN30ff RGB MODE 1 

STA AN30n (560 Res Monochrome 
STA AN30ff Double Hi-Res) 

STA AN30n 

STA Column800n 

STA AN30ff (double hi-res on) 

LDA $C057 hi-res 

JSR Convert LoResToDoubleHikes560 ( 


Q 


(an) 
(ee) 
= 
rr 
i] 
© 
o 
LS 5) 
ea 
© 
(an) 
et at = — J ..4 3 oS a eS a 
NAN Serre rre 
NA] OO C~I OD two I) 
OOoOODoO0O00000000 


JSR Pause 
O864- DO EO 1540 : BNE .1 branch always 
1550 Benn nnn nnn nn nen nn en == 

0866- AD 56 CO 1560 Pause2 LDA $C056 lo-res 
0869- 8D OC CO 1570 STA Column800ff 
O86C- 8D 5F CO 1580 STA AN30n (double hi-res off) 
LDA /$400 
STA LBas+1 , : 
STA ctr age counter too 
Pause inc $400 oered active mark rard for "a" 
LDA $C000 wait for any key 
BPL Pause ~e-e-not yet 

STA $C010 clear strobe 
CMP #38D clear Z-flag 
BNE . if NOT <return> 
PLA pop return address 
PLA f 
STA AN30n (double hi-res off) 
LDA $C051 text 
PLA recover 40/80 state 
BMI .1 --->was 80-col 
STA Column800ff raqrd for "b" and "c" 
STA Store800ff too 
RTS w/80 store off for 40-cols 
1 STA Column800n / 
“2 RTS w/80 store and 80-coles on 


0880- C9 8D 
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0892- 8 
6 
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12 BIT, 16 CHANNEL, 
PROGRAMMABLE GAIN A/D 

@ All new 1984 design incorporates the 
latest in state-of aa LC. technologies. 

@ Complete 12 bit A/D converter, withan 
accuracy of 0 02%! 


A/D & D/A 
A/D & D/A Features: 
Single PC card 

8 channels A/D 

B channels D/A 
Superfast Conversion ume 

Very easy programming 

Many analog ranges 

Manual contains sample applications 


A/D SPECIFICATIONS 
0.3% accutacy 
On-board memory 
Fast conversion (078 MS per channel) 
A/1) process lolally transparent to 
Apple (looks hke memory) 
User programmable input ranges are 
0to 10 volts, Oto 5S, Sto t5, 2.5 
to +25, StoU, 10to0 
The A/D) process takes place on a Continuous, 
channel sequencing basis Data is automatic: 
ally transferred to tts proper location in the 
on-board RAM, No A/D converter Could be 
Casiv’ to use. 


SIGNAL CONDITIONER 


Our 8 channel signal conditioner is designed toe use with both our A/D Converter. This 
board meorporates 6 FET. op-amps, which allow almost any gain or offset, For example, 
an mpul signal that vanes trom 2.00 to 2.15 volts of 2 signal that vanes trom 0 to 50 

MV can easily be Converted to 0-10V output for the A/D 


The signal conditioneds outputs ate on a high quality 16 pun gold LC socket that 
matches the one on the A/D's so 4a simple ribbon cable Connects the two. The signal 
conditioner can be powered by your Apple or from an external supply. 


@ To single ended Channels (ingle ended 
Means that your sagnals ate measured 
aguinst the Apple s GND) oF 8 
ditterential channels: Mast all the 
signals you well measure are single 
ended. 

@ 9 software programmable full scale 
tanges any ol the 16 channels Can have 
any range dt apy time Cader program 
control you can select any of the 
following ranges. ft TO volts. © 5V, 
£2.5V. +1.0V. + SODOMY, * 250MV, 
*1T00MV + SOMYV or t 25MV. 


FEATURES 

@ 45 square for standard card cage and 4 mounting holes for standard mounting. The 
signal Conditioner does not plug into the Apple, itcan be loc ated up to % mile away from 
the A/D) 

@ 22 pin 156 spacing edge Card input Connector (extra Connectors are easily available Le. 
Radio Shack) 


@ Latge bread board area. 


@ full detailed schematic included. 
Very last conversion (25 micto seconds) 


PRICE $79 


1,000,000 Ohins 
Laser timmed scaling resistors, 


e 
@ Analog input reslance greater than 
e 
e 


D/A SPECIFICATIONS 1/O 32 
Low power consumption through the @ 03% accuracy 
use of CMOS devices, @ On-bvard memory 
@ The user connector has #12 and -12 @ On-board output buffer amps can @ Provides 4, 8-Bit programmable I/O @ Your inputs can be anything from 
volts On bso you Can power your drive 5 MA Ports high speed logic to simple switches 
sensors @ D/A process iy totally transparent to 
Only elementary programming is the Apple Gust poke the data) @ Any of the 4 ports can be pro- @ Programming is made very easy by 
requied to use the A/D. @ Fast conversion (003 MS per channel) grammed as an input of an Output powerful on-board firmware 
@ User programmable output ranges are port 
@ The entice system is on one standard Oto § volts and 0 to 10 volts @ The 1/0 3215 your best choice for any 
size plugin card that fits neatly mside The D/A section contains 8 digital to analog @ All 1/O lines are TTL (0-5 volt) control application 
the Apple. converters, with output buffer amplifiers and compatible 


@ System inciudes sample programs on 


mor PRICE $319 
A few applications may include the mon 
toning of @ flow @ temperature @ hunidi- 
ty @ wind speed @ wind direction @ hight 
intensity @ pressure @ RPM ®@ soil mois- 
ture and many mure. 


allintertace logic on a single card On-card 
latches are provided for each of the eight 
D/A converters No D/A Converter Could be 
eaxer to use The onboard amplilier are 
lascetammed duong manutacture, thereby 
climinaling any requirement tot offset 


nuiling. PRICE $199 


The 1/O manual includes many programs tor inputs and outputs. 


Some applic ations include: 
Burglar glanm. daechon sensing ase with relays lo tun on lights, sound buszers, stunt 
motor, COntOr Lape recorders and printers, ase with digital yoystick 


PRICE $89 


Please see our other dull page adin tbe maya cine lon iidormaben on Apphed Fngincenoags Tooemaster Clock Card and other products forthe Apple. 
Our boards are far supenorto most of the Consumer electronies made today AILLC (ys ate high quality sockets with mil-spec, Components used throughout. P.C boards are glass epoxy 
with gold Contacts. Made in America to be the best in the world All products Compatible with Apple UW and //e 


Applied Engineering's products are tually tested with complete documentation aod available for immediate delivery. All products are puatantecd with a no hassle three year warranty 
Texas Residents Add 5% Sales Tax send Cheuk oEMuley (idee le Call (214)241-6060 
Add $10.00 1f Outside U.S.A. APPLIED ENGINEERING 9am. to 11 p.m. 7 days a week 
P.O. Box 798 MasterCard, Visa & C.0.D. Welcome 


Carrollton, TX 75006 No extra charge for credit catds 
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1130 Sooo eR 7 ac000 
O89A- AQ 20 1800 LDA /$2000 hi-res .page 1 
089C~ 85 2B 1810 STA HBas+1 
OR 3E- 8 1820 tya LDA #$00 even GR rows all 0 (background) 
O89F- 20 C2 08 1 Ro JSR. 
O8A2= AQ TF 1840 LDA #37F odd GR rows all 1 (fcreground) 
O8A4=- 20 C2 08 1850 JSR .3 
O8AT- 20 C2 09 1860 .1 JSR RBSC icks lo-res too 
O8AA- A2 08 1870 LDX #8 i-res lines/lo-res row parts etr 
O8AC- 2C 55 CO 1880 BIT AuxPage fill aux mem w/color nybbles 
O8AF- 20 CB 09 1830 -2 JSR NxtH store hi-res F-B pair/row pairs 
O8B2= CA 1900 DEX 
O8B3=- DO FA 1910 BNE .2 
O8B5= 2C 54 CO 1920 BIT MainPage 
O8B8- C8 es INY 
O8B9= DO EC 1940 BNE .1 
O8BB- E6 27 1950 INC LBas+1 
O8BD= C6 2E 1960 DEC ctr 
O8BF=- DO E6 EO BNE .1 loop for whole screen 
O8C1- 60 1980 RTS 
O8C2- A2 10 1990 3 LDX #$10 page counter 
O8C4H- 91 2A 2000 . STA (HBas),Y write main pixels 
O8C6- C8 2010 INY 
O8C7T= DO FB 2020 BNE .4 
O8C9= E6 2B 2030 INC HBas+1 
O8CB= CA 2040 DEX 
O8CC= DO F6 2050 BNE .4 
O8CE- 60 2060 RTS 
ere Convert LoResToDoubleHiRes 160 
O8CF- 20 C2 09 2080 .1 JSR RBSC picks lo-res too 
O8D2- 29 OF 2090 AND #$0F isolate even row nybble 
O8D4- 85 30 2100 STA Color 
O8D6—- 4A 2110 LSR line-up to left of msb 
O8D7= 20 ED 08 2120 JSR. 
O8DA= B1 26 2130 LDA (LBas),Y pe again 
O8DC= 29 FO 2140 AND #$F0 solate odd row nybble 
O8DE=- 85 30 2150 STA Color 
O8EO- 20 ED 08 2160 JSR. 
O8E3= C8 2170 INY 
O8E4—~ DO EY 2180 BNE .1 
O8E6=- E6 27 2190 INC LBas+1 
O8BE8- C6 2E 2200 DEC ctr 
O8EA- DO E3 2210 BNE .1 loop for whole screen 
O8EC=- 60 222 RTS 
O8ED= 6A 2230 .2 ROR 
O8EE= 6A 2240 ROR 
O8EF- 6A 2250 ROR 
O8F0=- 6A 2260 ROR 
O8F1i- 05 30 2270 ORA Color dup in other nybble 
O8F3- A2 O4 2280 LDX #4 hi-res lines/lo-res row ctr 
O8F5=- 2C 55 CO 2290 .3 BIT AuxPage 
O8F8- 91 2A 2300 STA (HBas),Y write aux $2XXX (or $3XXX) 
O8FA=- 2C 54 CO 2310 BIT MainPage 
O8FD- 20 CB 09 2320 JSR NxtH write main $2XXX (or $3XXX) too 
0900- CA 2330 DEX 
0901- DO F2 2340 BNE .3 
0903- 60 2350 RTS 
2360 * and for completeness; 
2370 Convert LoResToDoubleHiRes560 
0904- 98 2380 .1 TYA 
0905- OA 2390 ROR "column" lsb to carry 
0906—- 08 2400 PHP save for odd rows 
0907- 20 C2 09 2410 JSR RBSC picks lo-res too 
O90A= 29 OF 2420 AND #$0F isolate even row nybble 
090C= 20 23 09 aN JSR 
O90F- B1 2 24 LDA (LBas),Y pick again 
0911—- 4A 2450 LSR solate odd row nybble in LSN 
0912—- HA 2460 LSR 
0913- 4HA 2470 LSR 
0914—= 4A oy LSR 
0915= 28 2490 PLP recover "column" lsb 
0916= 20 23 09 2500 JSR .2 
0919- C8 2510 INY 
091A=- DO E8 2520 BNE .1 
091C- E6 27 2530 INC LBas+1 
O91E= C6 2E 2540 DEC ctr 
0920- DO E2 2550 BNE .1 loop for whole screen 
0922- 60 2560 RTS 
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2A 2570 .2 
OA 2580 
AA 2590 
AQ O4 2600 
85 2F 2610 
2C 55 CO 2620 .3 
BD 40 09 2630 
91 2A 2640 
2C 54 CO 2650 
Bb 6) 83 4s 
C6 2F 3670 
DO EB 2690 
60 2100 
2710 
2720 
2730 
2740 Monos 
ot? 
2760 
2770 
2780 
2790 
2800 
2810 
2820 
28 30 
2840 
2850 
3B90 
3RA6 
2890 
AQ CC 2900 Plot 
AO 10 2910 
18 2920 .1 
A2 03 2930 
a 30 29 40 
8 2950 .2 
99 00 O4 2960 
22 80 O4 2970 
9 11 29 
99 00 05 2990 
22 80 05 3000 
9 11 3010 
99 00 06 3020 
23 80 06 3030 
9 11 040 
99 00 07 3050 
99 80 07 0 
A5 30 ote 
CA 0 
10 DC 3090 
69 BC 3100 
BO D3 3110 
84 2A 3120 com... 
84 26 3130 
AD 52 CO 3140 
8D 01 CO 3150 
AD 50 CO 3160 
AD iF CO Me 
60 3180 
A5 2 3380 RBSC 
49 2 200 
85 2B 3210 
B1 26 3530 
60 $30 
91 2A 3240 NxtH 
E6 2B 3250 
E6 2B 260 
E6 2B 270 
E6 2B 280 
60 3290 
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ROL double, merging "column" bit 
ASL double again for 4 bytes each 
TAX and shove it in an index reg 
LDA #4 hi-res lines/lo-res row ctr 
STA ctr+1 another counter loc... 

BIT AuxPage 

LDA Monos, X 

STA (HBas),Y write aux $2XXX (or $3XXX) 
BIT MainPage 

LDA Monos+1,X 

JSR NxtH write main $2XXX (or $3XXX) too 
DEC ctr+1 should I have used Color? 
BNE . 

RTS 

.ma hs ".gen (off)" macro 

ehs j1 

em 

>hs 00.00.00.00 0--black 

>hs 11.22.44.08 1--magenta 

>hs .08.11.22 4--dar awe 

>hs 1h -GE 20. 3e foo ent blue 

>hs 08.11.22.44 8--brown 

>hs cal). -66 C-- ight green 

>hs 6E.5D.3B.77 E--aquamarine 

LDA #$CC start @ top-right 

LDY #16 

CLC 

LDX #3 

ore Color 00, 44, 88, CC 

STA $400,Y GR rows 0-3 

STA $480,Y 

ADC aaa 11, 55, ho DD 

STA : 00,Y GR rows 4-7 

STA $580,Y 

ADC #$11 22, 66, AA, EE 

STA $600,Y GR rows 8-11 

STA $680,Y 

ADC #$11 33, 77, BB, FF 

STA $700,Y GR rows 12-15 

STA $780,Y 

LDA Color 00, 44, 88, CC 

DEX 

BPL .2 

BCS .1 --e- more 

STY HBas Y-reg zero! 

STY LBas 

LDA $C052 solid (40 x 48 pixels) 

STA Store800n age 1 (main) assumed 
LDA $C050 graphics 

LDA ReadColumn80 

RTS 

LDA LBas+1, Bob's trick 

EOR /$20007 $400 

STA HBas+1 

EDA (LBas),Y pick lo-res even-odd row pair 
STA (HBas),Y store hi-res... 

INC HBas+1 new-old trick 

INC HBas+1 

INC HBas+1 

INC HBas+1 

RTS 


Copyright (C) S-C SOFTWARE 


Another Way Around the BRUN Problem.......Anonymous Caller 


This morning I turned on my phone answering machine to play 
back the overnight messages. An anonymous caller calmly said, 
"This iS an anonymous tip about the the BRUN problem under DOS. 
You can just BLOAD the program. Then CALL 41876, and the 
program will run properly and return nicely. You don't have to 
know the exact load address." 


I checked it out, and it looks like our caller isS correct. The 
BRUN processor inside DOS looks like this: 


A38E- JSR BLOAD 
A391- JSR IOHOOK 
A394- JMP (SAA72) 


By doing the complete BLOAD first, we have solved the problem 
of the trailing carriage return being printed after running our 
BRUNnable code. By the CALL 48176 (48176=$A394), we solve the 
problem of not Knowing where the code loaded. In effect we 
have created a new BRUN command, which leaves out the call to 
IOHOOK and completes its own echoing before executing our code. 


Thank you, Mr. Anonymous, whoever you are! 


RAMWORKS" 


ACCEPT NO SUBSTITUTES. 
BECAUSE THERE AREN’T ANY. 


There's only one card like RamWorks. We’ve got the best hardware 
design. We supply the best software and we've got the best support from 
software companies. 


If someone tempts you with an imitation, please get both sides of the 
story. You'll discover why RamWorks offers the best enhancements to 
AppleWorks and other programs, and at the lowest price. 


GUARANTEED! 


214-241-6060 Pg 


“We Set the Standard’”’ 
9 AM - 11 PM APPLIED ENGINEERING 
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With 7-80 Plus; 
run CP/M-the 
largest body of 
software in 
existence. 


Now, get two computers in one, 
and all the advantages of both. 


nter the CP/M world with the new Z-80 Plus card from Applied 

Engineering, and introduce vour Apple He® or [1 + ® to the thou- 
sands of CP/M programs. Only the Z-80 Plus comes standard with the 
new 4.0 software, the most advanced system ever for running CP/M 
programs. 

The new 4.0 boasts advanced features like built-in disk emulation for 
popular memory expansion boards. boosting both system speed and 
storage capacity. And menu-driven utilities that let you get to work faster. 
The Z-80 Plus also lets you run older CP/M programs — all the way down 
to Version 1.6 (2.2 is the most popular). 

The Z-80 Plus is the only card on the market capable of accessing 
more than 64K in an Apple Ile. If you have an extended 80-column 
card, all 128K is usabie, and if you have RamWorks, up to 1088K 
is available. 

Each Z-80 Plus comes with our CP/M Ram Drive software, enabling 
Ile owners to us® an extended 80-column card or a RamWorks card as a 
high-speed Ram disk which runs CP/M software up to awenty times faster 
So packages like WordStar and dBASE II run at blinding speed. 

Simply plug the Z-80 Plus into any slot in your Apple. You'll get the 
benefits of two computers in one — all at an unbelievably low price 
(only $139!). 


* Fully compatible wich ALL CP/M software * Fully compatible with 
most hard disks, including Corvus and the Sider * Fully compatible 
with Microsoft disks (no pre-boot required) * Specifically designed 
for high speed operation in the Apple He (runs just as fast in the 

Apple II + and Franklin) * Runs WordStar, dBASE II, Turbo Pascal, 
Fortran-80, Peachtree and ALL other CP/M software with no pre-boot 

* Semi-custem 1.C. and low parts count allows Z-80 Plus to fly through 
CP/M programs with extremely low power consumption (we use the 
Z-80B) * Does EVERYTHING other Z-80 boards do, plus Z-80 inter- 
rupts * Five year warranty 


Call to order today, 9 a.m. to 11 p.m. seven days, or send check or 
money order to Applied Engineering. MasterCard, VISA and C.O.D. 
welcome. Texas residents add 5% sales tax. Add $10.00 outside U.S.A. 


Vu wa Applied Engineering 
P.O. Box 798, Carroliton, TX 75006 
(214) 241-6060 


Page 28.....Apple Assembly Line....-August, 1986......Copyright (C) S-C SOFTWARE 


PEA, PEI, PER Instructions in 65802/16....Bob Sander-Cederlot 


These are three new instructions for pushing data on the stack 
which need more explanation than you find in the data sheet of 
these new chips. Furthermore, some mis-information has gotten 
out about them. 


All three push two bytes of data on the stack. Furthermore, it 
makes no difference whether you are in Emulation or Native 
mode, except for a minor problem which I will mention later. 


PEA (Push Effective Address) pushes the two bytes which follow 
the PEA opcode onto the stack. It is, in effect, a “push 
16-bit-immediate-value" instruction. Here is an example, with 
the equivalent in old-fashioned 6502 code also shown: 


——s 
0800- F4 34 12 PEA $1234 old § --> 
’ newS -> [| | 
0800- AQ 12 LDA /$1234 ae 
0802- 48 PHA 
0803- AQ 34 LDA #$1234 
0805- 48 PHA 


Notice that PEA takes 3 bytes and 5 cycles, while the 
equivalent 6502 code takes 6 bytes and 10 cycles. 


If you were in native mode with the m-status-bit cleared (that 
is, with A-register in 16-bit mode), and forgot about the PEA 
opcode, you might do this: 


O800- AI 34 12 LDA ##$1234 
0803- 48 


This approach takes 4 bytes and 7 cycles, and has the advantage 
or dis-advantage of leaving the data also in the A-register. 


PEI (Push Effective Indirect) pushes two bytes from the direct 
page onto the stack. You might think of it as “push (dir)". 
The byte at dirtl is pushed first, and then the byte at dir. 
Here 1S an example, with equivalent 6502 code: 


Assume D=$0000, $0055 contains $34 
$0056 contains $12 


O800- D4 55 PEI $55 Ola S --> 
New S --> 

O800- A5 56 LDA $56 

0802- 48 PHA 

0803- AS 55 LDA $55 

0805- 48 PHA 


PEI takes 2 bytes and 6 cycles, and the equivalent 6502 code 
takes 6 bytes and 12 cycles. In Native 16-bit mode, you could 
use LDA $55 to pick up both bytes, and a single PHA to push 
both of them. This would take 3 bytes and 8 cycles. 
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PER (Push Effective Relative) is very similar to the PEA 
instruction. By analogy, PER is to PEA as BRL is to JMP. The 
processor adds the value in the two bytes following the opcode 
to the contents of the PC-register, and pushes the result 
(high-byte first) onto the stack. Before the addition takes 
place, the PC-register will have already been advanced to the 
first byte of the next instruction. Here is an example: 


Co 
0800- 62 52 A2 PER $AA55 Old Ss --> [| AA | 
0803- 5k 


NewS -> {| ° | 
mange 


The value of PC after reading the PER instruction will be 
$0803. Adding $0803 to $A252 gives $AA55. 


There is an idiosyncrasy (bug?) in the 65802 and I presume in 
the 65816 in the emulation mode, having to do with instructions 
which push two bytes on the stack. The three instructions 
discussed here (PEA, PEI, and PER), aS well as the PHD 
instruction, all exhibit this problem. If the stack pointer is 
at $00 (remember, in emulation mode the stack pointer is only 
8-bits wide and always points into page 1), you would expect 
the two bytes to be stored at $0100 and SOIFF. However, the 
processor stores the "high" byte at $0100 as it should, and 
then stores the “low" byte at SOOFF instead of SOIFF. The 
following code will prove it to you, if you have the chip in 
your computer: 


LDX #$00 

STX SFF V7777, O1FF 
STX S$1FF New S --> L__| O1FE 
TXS 

PEA $1234 

LDA SFF Afterwards, S = SFE 

JSR SFDDA 

LDA $100 

JSR SFDDA 0101 
LDA S1FF Old S --> [12 | 0100 
JSR SFDDA | 34 | OOFF 
JMP $3D0 


The program above will print out "341200". This means that the 
PEA instruction pushed the value $34 into $00OFF, rather than 
SOlFF. If you plan to use these instructions in emulation 
mode, be sure you are aware of this un-expected case. 
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